<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Claude Code 完整使用指南 | Ctok</title>
    <meta name="description" content="目前最全的 Claude Code 使用指南，包含安装、配置、基础使用、MCP集成、安全管理等全方面内容">
    <link rel="icon" type="image/x-icon" href="favicon.ico">
    <style>
        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }
        
        body {
            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;
            line-height: 1.6;
            color: #333;
            background: #f8fafc;
        }
        
        .container {
            max-width: 1200px;
            margin: 0 auto;
            padding: 0 20px;
        }
        
        /* Header */
        .header {
            background: #fff;
            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
            position: sticky;
            top: 0;
            z-index: 100;
        }
        
        .header-content {
            display: flex;
            justify-content: space-between;
            align-items: center;
            padding: 15px 0;
        }
        
        .logo {
            font-size: 24px;
            font-weight: bold;
            color: #2563eb;
            text-decoration: none;
        }
        
        .nav {
            display: flex;
            list-style: none;
            gap: 30px;
        }
        
        .nav a {
            text-decoration: none;
            color: #64748b;
            font-weight: 500;
            transition: color 0.3s;
        }
        
        .nav a:hover, .nav a.active {
            color: #2563eb;
        }
        
        /* Article Layout */
        .article-container {
            display: grid;
            grid-template-columns: 250px 1fr;
            gap: 40px;
            padding: 40px 0;
            max-width: 1200px;
            margin: 0 auto;
        }
        
        /* Table of Contents */
        .toc {
            background: #fff;
            border-radius: 12px;
            padding: 30px;
            height: fit-content;
            position: sticky;
            top: 100px;
            border: 1px solid #e2e8f0;
        }
        
        .toc h3 {
            color: #1e293b;
            margin-bottom: 20px;
            font-size: 1.2rem;
        }
        
        .toc ul {
            list-style: none;
        }
        
        .toc ul ul {
            margin-left: 15px;
            margin-top: 5px;
        }
        
        .toc li {
            margin-bottom: 8px;
        }
        
        .toc a {
            color: #64748b;
            text-decoration: none;
            font-size: 0.95rem;
            transition: color 0.3s;
        }
        
        .toc a:hover {
            color: #2563eb;
        }
        
        /* Main Content */
        .main-content {
            background: #fff;
            border-radius: 12px;
            padding: 40px;
            border: 1px solid #e2e8f0;
        }
        
        .article-header {
            margin-bottom: 40px;
            padding-bottom: 30px;
            border-bottom: 2px solid #e2e8f0;
        }
        
        .article-header h1 {
            font-size: 2.5rem;
            color: #1e293b;
            margin-bottom: 15px;
            font-weight: 700;
        }
        
        .article-meta {
            color: #64748b;
            font-size: 1rem;
        }
        
        .content h2 {
            color: #1e293b;
            font-size: 1.8rem;
            margin: 40px 0 20px;
            padding-bottom: 10px;
            border-bottom: 1px solid #e2e8f0;
        }
        
        .content h3 {
            color: #374151;
            font-size: 1.4rem;
            margin: 30px 0 15px;
        }
        
        .content h4 {
            color: #4b5563;
            font-size: 1.2rem;
            margin: 25px 0 10px;
        }
        
        .content p {
            margin-bottom: 20px;
            line-height: 1.7;
            color: #374151;
        }
        
        .content ul, .content ol {
            margin: 20px 0;
            padding-left: 30px;
        }
        
        .content li {
            margin-bottom: 8px;
            line-height: 1.6;
        }
        
        .content code {
            background: #f1f5f9;
            padding: 2px 6px;
            border-radius: 4px;
            font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
            font-size: 0.9em;
            color: #e11d48;
        }
        
        .content pre {
            background: #1e293b;
            color: #e2e8f0;
            padding: 20px;
            border-radius: 8px;
            overflow-x: auto;
            margin: 20px 0;
        }
        
        .content pre code {
            background: none;
            padding: 0;
            color: inherit;
        }
        
        .highlight-box {
            background: #dbeafe;
            border-left: 4px solid #2563eb;
            padding: 20px;
            margin: 20px 0;
            border-radius: 4px;
        }
        
        .warning-box {
            background: #fef3c7;
            border-left: 4px solid #f59e0b;
            padding: 20px;
            margin: 20px 0;
            border-radius: 4px;
        }
        
        .step-number {
            background: #2563eb;
            color: #fff;
            width: 28px;
            height: 28px;
            border-radius: 50%;
            display: inline-flex;
            align-items: center;
            justify-content: center;
            font-weight: 600;
            margin-right: 10px;
        }
        
        /* Responsive */
        @media (max-width: 1024px) {
            .article-container {
                grid-template-columns: 1fr;
                gap: 20px;
            }
            
            .toc {
                position: static;
                order: -1;
            }
        }
        
        @media (max-width: 768px) {
            .header-content {
                flex-direction: column;
                gap: 20px;
            }
            
            .nav {
                gap: 15px;
                flex-wrap: wrap;
                justify-content: center;
            }
            
            .main-content {
                padding: 25px;
            }
            
            .article-header h1 {
                font-size: 2rem;
            }
        }
    </style>
</head>
<body>
    <header class="header">
        <div class="container">
            <div class="header-content">
                <a href="index.html" class="logo">Ctok</a>
                <nav>
                    <ul class="nav">
                        <li><a href="index.html">首页</a></li>
                        <li><a href="claude-code-complete-guide.html" class="active">使用指南</a></li>
                        <li><a href="claude-code-carpool.html">拼车服务</a></li>
                        <li><a href="en/">English</a></li>
                    </ul>
                </nav>
            </div>
        </div>
    </header>

    <div class="container">
        <div class="article-container">
            <aside class="toc">
                <h3>目录</h3>
                <ul>
                    <li><a href="#installation">1. 安装与配置</a>
                        <ul>
                            <li><a href="#system-requirements">系统要求</a></li>
                            <li><a href="#install-steps">安装步骤</a></li>
                            <li><a href="#initial-setup">初始配置</a></li>
                        </ul>
                    </li>
                    <li><a href="#basic-usage">2. 基础使用</a>
                        <ul>
                            <li><a href="#first-project">创建第一个项目</a></li>
                            <li><a href="#commands">核心命令</a></li>
                            <li><a href="#features">主要功能</a></li>
                        </ul>
                    </li>
                    <li><a href="#advanced">3. 高级功能</a>
                        <ul>
                            <li><a href="#mcp-integration">MCP集成</a></li>
                            <li><a href="#custom-prompts">自定义Prompts</a></li>
                            <li><a href="#collaboration">团队协作</a></li>
                        </ul>
                    </li>
                    <li><a href="#security">4. 安全管理</a></li>
                    <li><a href="#troubleshooting">5. 问题排查</a></li>
                    <li><a href="#best-practices">6. 最佳实践</a></li>
                </ul>
            </aside>

            <main class="main-content">
                <div class="article-header">
                    <h1>Claude Code 完整使用指南</h1>
                    <div class="article-meta">
                        最后更新：2024年1月 | 阅读时间：约30分钟
                    </div>
                </div>

                <div class="content">
                    <div class="highlight-box">
                        <p><strong>📖 本指南涵盖内容：</strong> Claude Code 的完整使用流程，从安装配置到高级功能，适合所有水平的开发者。无论你是初学者还是有经验的开发者，都能在这里找到有用的信息。</p>
                    </div>

                    <h2 id="installation">1. 安装与配置</h2>
                    
                    <h3 id="system-requirements">系统要求</h3>
                    <p>在开始安装之前，请确保你的系统满足以下要求：</p>
                    <ul>
                        <li>操作系统：Windows 10+、macOS 10.15+、Linux (Ubuntu 18.04+)</li>
                        <li>Node.js 16.0.0 或更高版本</li>
                        <li>至少 4GB 可用内存</li>
                        <li>稳定的网络连接</li>
                    </ul>

                    <h3 id="install-steps">安装步骤</h3>
                    
                    <p><span class="step-number">1</span>首先安装 Claude Code CLI：</p>
                    <pre><code>npm install -g @anthropic/claude-code</code></pre>
                    
                    <p><span class="step-number">2</span>验证安装是否成功：</p>
                    <pre><code>claude-code --version</code></pre>
                    
                    <p><span class="step-number">3</span>登录你的 Claude 账户：</p>
                    <pre><code>claude-code auth login</code></pre>

                    <h3 id="initial-setup">初始配置</h3>
                    <p>完成安装后，需要进行一些基本配置：</p>
                    
                    <h4>配置 API 密钥</h4>
                    <pre><code>claude-code config set api-key YOUR_API_KEY</code></pre>
                    
                    <h4>设置默认模型</h4>
                    <pre><code>claude-code config set model claude-3-sonnet</code></pre>
                    
                    <div class="warning-box">
                        <p><strong>⚠️ 注意：</strong> 请妥善保管你的 API 密钥，不要在公共代码库中暴露。建议使用环境变量或安全的配置文件管理。</p>
                    </div>

                    <h2 id="basic-usage">2. 基础使用</h2>
                    
                    <h3 id="first-project">创建第一个项目</h3>
                    <p>让我们创建一个简单的项目来熟悉 Claude Code：</p>
                    
                    <p><span class="step-number">1</span>创建新目录并初始化：</p>
                    <pre><code>mkdir my-claude-project
cd my-claude-project
claude-code init</code></pre>
                    
                    <p><span class="step-number">2</span>创建一个简单的 Python 脚本：</p>
                    <pre><code>claude-code create --file hello.py --prompt "创建一个打印问候语的Python脚本"</code></pre>

                    <h3 id="commands">核心命令</h3>
                    <p>Claude Code 提供了丰富的命令集，以下是最常用的命令：</p>
                    
                    <h4>文件操作命令</h4>
                    <ul>
                        <li><code>claude-code create</code> - 创建新文件或代码</li>
                        <li><code>claude-code edit</code> - 编辑现有文件</li>
                        <li><code>claude-code review</code> - 代码审查</li>
                        <li><code>claude-code explain</code> - 解释代码功能</li>
                    </ul>
                    
                    <h4>项目管理命令</h4>
                    <ul>
                        <li><code>claude-code init</code> - 初始化项目</li>
                        <li><code>claude-code status</code> - 查看项目状态</li>
                        <li><code>claude-code analyze</code> - 分析项目结构</li>
                        <li><code>claude-code optimize</code> - 优化代码性能</li>
                    </ul>

                    <h3 id="features">主要功能</h3>
                    
                    <h4>智能代码生成</h4>
                    <p>Claude Code 可以根据自然语言描述生成高质量的代码：</p>
                    <pre><code>claude-code generate --prompt "创建一个RESTful API端点用于用户认证" --language python</code></pre>
                    
                    <h4>代码重构与优化</h4>
                    <p>自动重构和优化现有代码：</p>
                    <pre><code>claude-code refactor --file app.py --focus "性能优化"</code></pre>
                    
                    <h4>自动测试生成</h4>
                    <p>为你的代码自动生成测试用例：</p>
                    <pre><code>claude-code test --file utils.py --framework pytest</code></pre>

                    <h2 id="advanced">3. 高级功能</h2>
                    
                    <h3 id="mcp-integration">MCP集成</h3>
                    <p>Model Context Protocol (MCP) 允许 Claude Code 与外部工具和服务集成。</p>
                    
                    <h4>安装MCP服务器</h4>
                    <pre><code>claude-code mcp install @anthropic/mcp-server-filesystem
claude-code mcp install @anthropic/mcp-server-git</code></pre>
                    
                    <h4>配置MCP服务器</h4>
                    <p>编辑 <code>claude-config.json</code> 文件：</p>
                    <pre><code>{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "mcp-server-filesystem",
        "args": ["/path/to/project"]
      }
    }
  }
}</code></pre>

                    <h3 id="custom-prompts">自定义Prompts</h3>
                    <p>创建和管理自定义提示模板：</p>
                    
                    <h4>创建提示模板</h4>
                    <pre><code>claude-code prompt create --name "api-generator" --template "创建一个{framework} API端点，功能是{功能描述}"</code></pre>
                    
                    <h4>使用自定义提示</h4>
                    <pre><code>claude-code generate --prompt-template api-generator --vars framework=FastAPI,功能描述=用户管理</code></pre>

                    <h3 id="collaboration">团队协作</h3>
                    <p>Claude Code 支持团队协作功能：</p>
                    
                    <ul>
                        <li>共享配置和提示模板</li>
                        <li>代码审查工作流</li>
                        <li>团队代码标准检查</li>
                        <li>协作开发会话</li>
                    </ul>

                    <h2 id="security">4. 安全管理</h2>
                    <p>使用 Claude Code 时需要注意以下安全事项：</p>
                    
                    <ul>
                        <li>不要在代码中硬编码敏感信息</li>
                        <li>使用环境变量管理配置</li>
                        <li>定期更新 Claude Code 和相关依赖</li>
                        <li>遵循最小权限原则</li>
                    </ul>
                    
                    <div class="highlight-box">
                        <p><strong>💡 安全提示：</strong> 建议在企业环境中使用私有部署或VPN连接，确保代码和数据的安全性。</p>
                    </div>

                    <h2 id="troubleshooting">5. 问题排查</h2>
                    
                    <h3>常见问题及解决方案</h3>
                    
                    <h4>Q: Claude Code 无法连接到服务器</h4>
                    <p><strong>A:</strong> 请检查网络连接和API密钥设置：</p>
                    <pre><code>claude-code config get api-key
claude-code test connection</code></pre>
                    
                    <h4>Q: 生成的代码质量不理想</h4>
                    <p><strong>A:</strong> 尝试以下方法：</p>
                    <ul>
                        <li>提供更详细的描述</li>
                        <li>指定编程语言和框架</li>
                        <li>使用示例代码作为参考</li>
                    </ul>
                    
                    <h4>Q: MCP服务器无法启动</h4>
                    <p><strong>A:</strong> 检查MCP服务器配置和权限：</p>
                    <pre><code>claude-code mcp status
claude-code mcp logs</code></pre>

                    <h2 id="best-practices">6. 最佳实践</h2>
                    
                    <h3>代码质量</h3>
                    <ul>
                        <li>使用清晰、具体的提示描述</li>
                        <li>定期审查生成的代码</li>
                        <li>遵循项目的编码标准</li>
                        <li>添加适当的注释和文档</li>
                    </ul>
                    
                    <h3>工作流优化</h3>
                    <ul>
                        <li>创建可复用的提示模板</li>
                        <li>设置项目特定的配置</li>
                        <li>使用版本控制管理代码变更</li>
                        <li>定期备份重要配置</li>
                    </ul>
                    
                    <h3>团队合作</h3>
                    <ul>
                        <li>建立统一的代码风格指南</li>
                        <li>共享有用的提示模板</li>
                        <li>定期分享使用经验</li>
                        <li>建立代码审查流程</li>
                    </ul>

                    <div class="highlight-box">
                        <p><strong>🎯 总结：</strong> Claude Code 是一个强大的AI编程助手，通过正确的配置和使用，可以显著提升开发效率。记住要保持代码质量意识，合理使用AI辅助，而不是完全依赖。</p>
                    </div>
                </div>
            </main>
        </div>
    </div>
</body>
</html>